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SPECIFICATION 
TO ALL WHOM IT MAY CONCERN: 

We, Samuel Daniel Dull, III, James E. Favre, and Shawn Michael Hanson have invented 
certain new and useful improvements in a: 



Method and Apparatus for Installing and Upgrading 
an Application in a Computer System 



of which the following is a specification. 
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Title: Method and Apparatus for Installing and Upgrading an Application in a 

Computer System 

Field of the Invention 

The present invention generally relates to methods of installing, configuring, and 
upgrading programs within a computer system, and application programs for facilitating these 
methods. More particularly, the present invention relates to a simpler method of installing, 
upgrading, and configuring databases using an instruction processing program. 

Background of the Invention 

The development of the ED VAC computer system of 1948 is often cited as the beginning 
of the computer era. Since that time, computer systems have evolved into extremely complicated 
devices. To be sure, today's computers are more sophisticated than early systems such as the 
ED VAC. Fundamentally speaking, though, the most basic requirements levied upon computer 
systems have not changed. Now, as in the past, a computer system's job is to access, manipulate, 
and store information. This fact is true regardless of the type or vintage of computer system. 

Many large organizations own thousands of individual computers, which are located 
throughout the organization's facilities. Each individual computer manipulates information by 
following a detailed set of instructions, commonly called a "program" or "software." These 
programs frequently require changes ("updates," "upgrades," or "fixes") to correct errors ("bugs") 
in the program and to add new functionality. That is, users frequently want to change the 
particular set of instructions to be performed by the computer to add new features and to fix bugs. 
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One problem with conventional upgrading techniques is that each upgrade must be 
performed on each copy of the program. Thus, if a business has 2000 copies of a particular piece 
of software, each upgrade procedure must be performed 2000 times. This can require a 
substantial investment of time. This problem is compounded because, as software systems have 
5 increased in complexity, the level of experience and the time required to perform each upgrade 
has also increased. Today, even relatively simple changes to the programs can require large 
amounts of time by highly skilled employees. 
% Organizations also need to add ("install") new software programs onto their existing 

fy computers from time to time. Like conventional upgrade methods, conventional software 
10'y3 installation methods often required that a highly technically sophisticated employee physically go 
to each computer and add the new software. Again, for a large organization, this consumes 
7Ci substantial resources. 

fy One partial solution to these problems required the developer of a particular piece of 

P software to create an external application that upgrades the primary software. This new 
15 "installation program" is then distributed to each end user and executed. However, these 

programs are difficult to create, and as a result, divert scarce development resources away from 
the primary software program. Installation programs are also relatively large, which can 
significantly increase the computer resources necessary to perform the upgrade. 

Accordingly, a need exists for a simpler method for installing and upgrading software on a 
20 computer system. 



3 



ROC920010099US1 



Summary of the Invention 

The present invention uses simple data objects that allow the computer system to upgrade 
itself, requesting user input only when needed. These data objects can be created quickly and are 
easily modified to suit each individual installation. They can also provide the ability to remotely 
track the progress of an installation by maintaining start and completion times as properties of 
themselves. In addition, each upgrade object can include prerequisite information, which allows 
the upgrade to be performed by independent processes if the prerequisites have been completed. 

One aspect of the present invention is a method of upgrading a computer program on a 
computer system, the computer system including an instruction processing program. One 
embodiment of this method comprises receiving an upgrade object associated with the computer 
program, the upgrade object including an instruction set adapted for use by the instruction 
processing program, and executing the instruction set with the instruction processing program. 
Another embodiment of this method comprises creating an upgrade object associated with the 
computer program, the upgrade object including an instruction set adapted for use by the 
instruction processing program; transmitting the upgrade object to the computer system; and 
instructing an end user to execute the instruction set with the instruction processing program. 

Another aspect of the present invention is a method of installing a computer program on a 
computer system, the computer system including an instruction processing program. One 
embodiment of this method comprises receiving an installation object associated with the 
computer program, the installation object including an instruction set adapted for use by the 
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instruction processing program, and executing the instruction set with the instruction processing 
program. Another embodiment of this method comprises creating an installation object associated 
with the computer program, the installation object including an instruction set adapted for use by 
the instruction processing program; transmitting the installation object to the computer system; 
and instructing an end user to execute the instruction set with the instruction processing program. 

Still another aspect of the present invention is a computer program product, one 
embodiment of which comprises an upgrade object configured to upgrade a software program on 
a computer system having an instruction processing program, the upgrade object including an 
instruction set capable of causing the instruction processing program to perform one or more 
upgrade tasks, and a signal bearing media bearing the upgrade object. 

One feature and advantage of the present invention is that it allows end users to install and 
upgrade software with minimal intervention and with little required expertise. The present 
invention also allows software developers to create and distribute upgrades quicker and easier. 
These and other features, aspects, and advantages will become better understood with reference 
to the following description, appended claims, and accompanying drawings. 

Brief Description of the Drawings 

Figure 1 is a schematic diagram of a computer system. 

Figure 2 is a diagram showing one upgrade object embodiment. 

Figure 3 is a flowchart depicting one embodiment of the present invention adapted for use 
in upgrading a database in the Lotus® Notes® program. 
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Detailed Description 

Figure 1 depicts a computer 100 embodiment having a processor 110 connected to a main 
memory 120, a mass storage interface 130, an I/O interface 140, and a network interface 145 via 
a system bus 160. The mass storage interface 130 connects one or more mass storage devices 
155, such as a hard disk drive, to the system bus 160. The input/output ("I/O") interface 140 
connects one or more input/output devices 165, such as a keyboard, to the system bus 160. The 
network interface 150 connects the computer 100 to other computers 100 (not shown) over an 
appropriate communication medium 170, such as the Internet. The memory 120 contains an 
operating system 175, a program to be upgraded 180, a communication program 185, and a script 
processing program 190. 

Figure 2 shows one embodiment of an upgrade object 200. This upgrade object 200 
comprises a release field 210, a control information field 220, a description field 230, and step 
code field 240. The control information field 220 comprises a title field 233, a step number field 
224, a prerequisites field 226, a concurrent step field 228, and a release field 229. The description 
field 230 includes a human readable explanation 235 of what the actions that upgrade object 200 
will perform. The step code field 240 comprises a plurality of instructions 242 ("script") in text 
format, which are capable of being converted into a machine-useable form ("compiled") and 
executed by the script processing program 190 (Fig. 1). 

In operation, the present invention provides a method of installing, upgrading, and 
maintaining software in which the end user has a very small role in the total picture. In the 
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embodiment shown in Figs 1-2, a system administrator will first install (or instruct the end users to 
install) the program to be upgrated 180, the communications program 185, the script processing 
program 190 onto each individual computer 100. These programs may be installed using 
conventional methods, such as using a special purpose installation program stored on a suitable 
5 storage medium. 

When the system administrator determines that it is necessary to upgrade the program 
180, the system administrator will prepare a group of upgrade objects 200 and will send the 
fp objects 200 to the end user. Each upgrade object 200 contains a logically related group of tasks, 
JK some of which may require user interaction and some of which may be entirely automatic. A 
10, j typical upgrade will use between three and ten upgrade objects 200. 
C3 In response to receiving the upgrade objects 200, the end user will instruct the script 

processing program 190 residing on his computer to begin compiling and executing the 
X instructions contained in the first upgrade object's step code field 240. The script processing 
m program 190 will then check to make sure any necessary prerequisites have been met and will 
15 begin to execute the instructions contained in the step code field 240, prompting the end user as 
needed. After completing the instructions in the first object 200, the script processing program 
190 will record that the particular upgrade object 200 was successfully completed and will report 
this information back to the system administrator. The script processing program 190 will then 
repeat these actions on the next upgrade object 200, until all of the upgrade objects 200 
20 associated with the upgrade have been completed. 
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The communications program 185 can be any device capable of receiving the upgrade 
objects from the system administrator and providing the script instructions 242 to the script 
processing program 190. Suitable programs include, but are not limited to, electronic mail 
programs and file transfer protocol programs. Electronic mail programs may be particularly 
desirable because the system administrator may initiate the upgrade process shown in Fig. 3 by 
simply mailing the upgrade objects 200 to the end user. 

The script processing program 190 may be any apparatus capable of reading the script 
instructions 242 and causing the computer 100 to perform the corresponding tasks. In many 
embodiments, the scripting program will compile the script instructions 242 into the preferred 
form for the particular computer 100 that receives the object. One suitable script processing 
program 190 is the Lotus® Notes® program produced by Lotus Development Corporation of 
Cambridge, Massachusetts. This program is desirable because it provides electronic mail 
functions, allows end users to compile and execute scripts sent via electronic mail, and is already 
fully developed. Thus, the system administrator does not need to develop and install special 
purpose scripting and communication software to practice the invention. 

In this embodiment, the release field 210 will contain a release value. Each object 200 in 
the upgrade package will share a common release value. This release value can be an explicit 
property, like a text field with specific value, or it can be implied by some other mechanism, such 
as being distributed with a group of instructions. The step number field in this embodiment 
contains a sequence number. Like the release value, the sequence number can be an explicit field 
like a number field, or can be implied by some other method. The prerequisites in the 
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prerequisites field 226 list what previous upgrades must have been performed and/or what 
hardware or software is required to perform the upgrade. Those skilled in the art will recognize 
that these prerequisites may frequently implied from and/or duplicative of the sequence number 
204. However, some embodiments may use the prerequisites to allow some steps to be run out of 
order. These embodiments may be particularly desirable if one of the steps in the upgrade requires 
the computer 100 to access a particular outside resource. 

Some upgrade object 200 embodiments may also include a start time field and an end time 
field, (not shown). These fields may be desirable for use in managing the instruction set. Some 
object embodiments may also contain an instruction type field (not shown). This field may be 
desirable to distinguish between instructions that require user action and instructions that may be 
performed entirely automatically. Those skilled in the art will recognize that this information by 
also be implied by the contents of the script. 

Figure 3 is a flowchart depicting one embodiment of the present invention adapted for use 
in upgrading a Lotus® Notes® program database called "Pipeline." At block 300, the system 
administrator and/or the end user will install the communication program 185 and script 
processing program 190 on the end user's computer 100. When the system administrator 
determines that the end user's computer needs upgrading or additional software, the system 
administrator sends a group of installation objects to the end user at block 301. Also at block 
301, the end user will initiate the "AutoInstalT function. This function is contained within the 
existing script processing program, and will cause it to begin compiling and executing the script. 



9 



ROC920010099US1 

In the specific embodiment shown in Figure 3, the Autolnstall function is an action either in a 
Lotus® Notes® program view or document. 

At block 302, the Autolnstall function will locate the first data object in the instruction set, 
which in this specific embodiment is a simple Lotus® Notes® document. Before continuing with 
5 the Lotus® Notes® object, it is determined at block 303 whether the object has already been 

started elsewhere. If the object has been started, the end user chooses (at block 304) whether to 
skip this object and continue to the next object (i.e., return to block 302), or to repeat this block. 
% If the instruction has not previously been started or the user has decided to repeat it, the object is 
f{l then checked at block 305 to be sure the prerequisites have been met. If the prerequisites have not 
lOy been met, the installation fails and the system administrator is notified at block 306. If the 
^ prerequisites have been met, the object is time-stamped and the type of instruction is determined 
rj at block 307. If it is a manual instruction, the text of the instruction is presented to the end user at 
fQ block 308. If it is an automatic instruction, the text of the instruction is interpreted and executed 
at block 309. In this embodiment, the LotusScript® EXECUTE statement is used to accomplish 
15 this block. Once the instruction has been completed, the instruction is time- stamped at block 310, 
then checked to see if it is the last instruction. If it is the last instruction, the user is notified at 
block 312 of a successful installation and the function terminates. If it is not the last block, the 
process is continued on the next instruction object at block 302. 

Referring again to Figure 1, the processor 1 10 in the computer 100 may be constructed 
20 from one or more microprocessors and/or integrated circuits. Processor 1 10 executes program 
instructions stored in main memory 120. Main memory 120 stores programs and data that the 
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processor 110 may access. When computer 100 starts up, the processor 110 initially executes the 
program instructions that make up the operating system 124. The operating system 175 is a 
sophisticated program that manages the resources of the computer 100, Some of these resources 
are the processor 1 10, the main memory 120, the mass storage interface 130, the input/output 
interface 140, the network interface 150, and the system bus 160. 

The I/O interface 140 directly connects the system bus 160 to one or more I/O devices 
165, such as a keyboard, mouse, or cathode ray tube. Note, however, that while the I/O interface 
140 is provided to support communication with one or more I/O devices 165, some computer 100 
embodiments do not require an I/O device 165 because all needed interaction with other 
computers 100 occurs via network interface 150. 

Although the computer 100 is shown to contain only a single processor 110 and a single 
system bus 160, those skilled in the art will appreciate that the computer 100 may have multiple 
processors 110 and/or multiple buses 160. In addition, the interfaces may also each include a 
separate, fully programmed microprocessor. These embodiments may be desirable because the 
interface processors can off-load compute-intensive processing from processor 110. However, 
those skilled in the art will appreciate that the present invention applies equally to computers 100 
that simply use I/O adapters to perform similar functions. 

The network interface 150 is used in this embodiment to connect other computers and/or 
devices to the computer 100 across a network 170. The present invention applies equally no 
matter how the computer 100 may be connected to other computers and/or devices, regardless of 
whether the network connection 170 is made using present-day analog and/or digital techniques 
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or via some networking mechanism of the future. In addition, many different network protocols 
can be used to implement the communication between the computers and/or devices. One 
suitable network protocol is the Transmission Control Protocol/Internet Protocol ("TCP/IP"). 

The mass storage interface 130 in this embodiment directly connects the system bus 160 to 
one or more mass storage devices 155. The mass storage devices 155, in turn, may be any 
apparatus capable of storing information on and/or retrieving information from a mass storage 
medium 195. Suitable mass storage devices 155 and mediums 155 include, without limitation, 
hard disk drives, CD-ROM disks and drives, DVD disks and drives, tapes and tape drives. 
Additionally, although the mass storage device 155 is shown directly connected to the system bus 
160, embodiments in which the mass storage device 155 is located remote from the computer 100 
are also within the scope of the present invention. 

Although the present invention has been described in detail with reference to certain 
examples thereof, it may be also embodied in other specific forms without departing from the 
essential spirit or attributes thereof. For example, the present invention may be used to install 
new programs onto the computer 100 and/or to delete unnecessary programs from the computer 
100. It may also be used to initiate periodic maintenance tasks, such as defragmenting the hard 
disk drive, scanning the computer 100 for computer viruses, backing up data, and the like. The 
present invention, and components thereof, are also capable of being distributed as a program 
product in a variety of forms, and applies equally regardless of the particular type of signal bearing 
media used to actually carry out the distribution. Examples of suitable signal bearing media 
include, without limitation: recordable type media, such as floppy disks and CD-RW disks, CD- 
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ROM, DVD, and transmission type media, such as digital and analog communications links. In 
addition, some embodiments may replace or supplement the text script 242 in Figure 2 with binary 
code. These embodiments may be desirable because they may require fewer resources from the 
end user's computer. 

The present invention offers numerous advantages over conventional installation and 
upgrade methods. For example, the end user will only need to perform actions for one or two 
steps in the typical process. This allows relatively inexperienced end users to perform the upgrade 
and/or installation, rather than more experienced system administrators. Embodiments of the 
present invention also provide for automatic reporting and user interaction if an error occurs 
during the upgrade process. These embodiments may be desirable because they provide the 
system administrator with a detailed list of which upgrades have been installed on each computer 
and, in the case of an error, at what step in the upgrade process the error occurred. This 
information can help the system administrator diagnose what caused the error. In addition, 
embodiments of the present invention allow the system administrator to use functionality already 
present on the end user's computer 100, which decreases the effort required to prepare the 
upgrade objects and reduces the size of the resulting objects. That is, because the upgrade objects 
200 in these embodiments use functionality present in the script processing program 190, the 
upgrade object 200 can be smaller and simpler than the installation programs used in the prior art. 
This feature also allows the system administrator to create generic upgrade objects 200 and to 
rely upon the script processing program 190 to customize the resulting upgrade for the end user's 
computer 100. 
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The accompanying figures and this description depicted and described embodiments of the 
present invention, and features and components thereof. It is desired that the embodiments 
described herein be considered in all respects as illustrative, not restrictive, and that reference be 
made to the appended claims for determining the scope of the invention. 
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